home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / sigsetops.z / sigsetops
Encoding:
Text File  |  2002-10-03  |  8.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSIIIIGGGGSSSSEEEETTTTOOOOPPPPSSSS((((3333))))                                                      SSSSIIIIGGGGSSSSEEEETTTTOOOOPPPPSSSS((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sigsetops: sigaddset, sigdelset, sigemptyset, sigfillset, sigismember,
  10.      sgi_altersigs, sgi_sigffset, sgi_siganyset, sgi_dumpset - signal set
  11.      manipulation and examination routines (POSIX, with SGI-specific
  12.      additions)
  13.  
  14. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.    _P_O_S_I_X
  16.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssiiiiggggnnnnaaaallll....hhhh>>>>
  17.  
  18.      iiiinnnntttt ssssiiiiggggaaaaddddddddsssseeeetttt((((ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt,,,, iiiinnnntttt ssssiiiigggg))));;;;
  19.  
  20.      iiiinnnntttt ssssiiiiggggddddeeeellllsssseeeetttt((((ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt,,,, iiiinnnntttt ssssiiiigggg))));;;;
  21.  
  22.      iiiinnnntttt ssssiiiiggggeeeemmmmppppttttyyyysssseeeetttt((((ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt))));;;;
  23.  
  24.      iiiinnnntttt ssssiiiiggggffffiiiillllllllsssseeeetttt((((ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt))));;;;
  25.  
  26.      iiiinnnntttt ssssiiiiggggiiiissssmmmmeeeemmmmbbbbeeeerrrr((((ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt,,,, iiiinnnntttt ssssiiiigggg))));;;;
  27.  
  28.    _S_G_I
  29.      iiiinnnntttt ssssggggiiii____aaaalllltttteeeerrrrssssiiiiggggssss((((iiiinnnntttt aaaaccccttttiiiioooonnnn,,,, ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt,,,, iiiinnnntttt ssssiiiiggggaaaarrrrrrrraaaayyyy[[[[]]]]))));;;;
  30.  
  31.      iiiinnnntttt ssssggggiiii____ssssiiiiggggffffffffsssseeeetttt((((ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt,,,, iiiinnnntttt cccclllleeeeaaaarrrriiiitttt))));;;;
  32.  
  33.      iiiinnnntttt ssssggggiiii____ssssiiiiggggaaaannnnyyyysssseeeetttt((((ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt))));;;;
  34.  
  35.      iiiinnnntttt ssssggggiiii____dddduuuummmmppppsssseeeetttt((((ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt))));;;;
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      These library calls modify or return information about the disposition of
  39.      the signal mask pointed to by _s_e_t. The system defines a set of signals
  40.      that may be delivered to a process.  Signal delivery resembles the
  41.      occurrence of a hardware interrupt:  the signal is blocked from further
  42.      occurrence, the current process context is saved, and a new one is built.
  43.      A global _s_i_g_n_a_l _m_a_s_k defines the set of signals currently blocked from
  44.      delivery to a process; it may be changed with a _s_i_g_p_r_o_c_m_a_s_k(2) call.  The
  45.      masks submitted as parameters to _s_i_g_p_r_o_c_m_a_s_k, _s_i_g_a_c_t_i_o_n, and _s_i_g_s_u_s_p_e_n_d
  46.      and returned by _s_i_g_p_e_n_d_i_n_g may be constructed, altered, and examined via
  47.      the sigsetops described in this man page.  They do _N_O_T themselves alter
  48.      the global signal mask.  The masks that the routines manipulate are of
  49.      type _s_i_g_s_e_t__t.
  50.  
  51.      _s_i_g_a_d_d_s_e_t adds _s_i_g to the specified set.
  52.  
  53.      _s_i_g_d_e_l_s_e_t deletes _s_i_g from the specified set.
  54.  
  55.      _s_i_g_e_m_p_t_y_s_e_t clears all signals in the specified set.
  56.  
  57.      _s_i_g_f_i_l_l_s_e_t sets all signals in the specified set.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSIIIIGGGGSSSSEEEETTTTOOOOPPPPSSSS((((3333))))                                                      SSSSIIIIGGGGSSSSEEEETTTTOOOOPPPPSSSS((((3333))))
  71.  
  72.  
  73.  
  74.      _s_i_g_i_s_m_e_m_b_e_r returns 1 if _s_i_g is a member of the specified set, else
  75.      returns 0.
  76.  
  77. SSSSGGGGIIII----SSSSPPPPEEEECCCCIIIIFFFFIIIICCCC FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  78.      The following four functions, although _n_o_t part of the POSIX
  79.      specification, provide additional capabilities:
  80.  
  81.      _s_g_i__a_l_t_e_r_s_i_g_s performs _a_c_t_i_o_n on the specified signal set, for each
  82.      signal in _s_i_g_a_r_r_a_y. _A_c_t_i_o_n may be ADDSIGS or DELSIGS (defined in
  83.      <_s_y_s/_s_i_g_n_a_l._h).  The final signal entry in _s_i_g_a_r_r_a_y must be followed by a
  84.      0 entry (in this way _s_g_i__a_l_t_e_r_s_i_g_s knows how many signals to process).
  85.      The array may include all legal signals; however, if the intent is to set
  86.      or clear all signals the _s_i_g_a_d_d_s_e_t and _s_i_g_d_e_l_s_e_t routines are more
  87.      efficient.  Any illegal signal numbers are silently skipped.
  88.      _s_g_i__a_l_t_e_r_s_i_g_s returns the number of signals which were processed, or -1
  89.      with _e_r_r_n_o set to [[[[EEEEIIIINNNNVVVVAAAALLLL]]]] if _a_c_t_i_o_n is not ADDSIGS or DELSIGS.
  90.  
  91.      _s_g_i__s_i_g_f_f_s_e_t returns the number of the lowest pending signal in _s_e_t. If
  92.      none are pending, it returns 0.  If _c_l_e_a_r_i_t is non-zero, the returned
  93.      signal is cleared in the mask.  In this way _s_g_i__s_i_g_f_f_s_e_t may be used to
  94.      sequentially examine the signals in a mask without duplication.
  95.  
  96.      _s_g_i__s_i_g_a_n_y_s_e_t(_s_e_t) returns 1 if _a_n_y signals are set in the specified
  97.      mask, otherwise it returns 0.  The mask is not altered.
  98.  
  99.      _s_g_i__d_u_m_p_s_e_t displays the specified set of signals as a bit-vector,
  100.      primarily for debugging purposes.
  101.  
  102.      For a list of valid signal numbers please see _ssss_iiii_gggg_nnnn_aaaa_llll(5).
  103.  
  104. EEEERRRRRRRROOOORRRRSSSS
  105.      In every routine, the _s_e_t parameter is a _p_o_i_n_t_e_r to sigset_t.  All of
  106.      these functions are library routines (executing in user space); therefore
  107.      if they are passed a _R_E_F_E_R_E_N_C_E to _s_e_t instead of a _P_O_I_N_T_E_R, the compiler
  108.      will issue a warning, and when the program is run the process will
  109.      receive a memory fault signal [SSSSIIIIGGGGSSSSEEEEGGGGVVVV] and terminate (unless the process
  110.      has installed a handler for SSSSIIIIGGGGSSSSEEEEGGGGVVVV).
  111.  
  112.      All routines which require a _s_i_g parameter will fail, returning -1 and
  113.      setting _e_r_r_n_o to [[[[EEEEIIIINNNNVVVVAAAALLLL]]]] if _s_i_g is not a valid signal number.
  114.  
  115. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  116.      sigaction(2), sigprocmask(2), sigpending(2), sigsuspend(2), sigsetjmp(3),
  117.      pthread_sigmask(3P).
  118.  
  119. WWWWAAAARRRRNNNNIIIINNNNGGGG
  120.      The POSIX and System V signal facilities have different semantics.  Using
  121.      both facilities in the same program is ssssttttrrrroooonnnnggggllllyyyy ddddiiiissssccccoooouuuurrrraaaaggggeeeedddd and will
  122.      result in unpredictable behavior.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.